home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / demovers / ergo_pro / 10_steps.txt next >
Text File  |  1998-10-29  |  14KB  |  266 lines
  1. ==========================================================================
  2.                               
  3.                     ERGO!pro  IN  10  SCHRITTEN
  4.  
  5.           Ein Schnellkurs zur Demo-Version von ERGO!pro 2.0
  6.  
  7. ==========================================================================
  8. Willkommen beim ERGO!pro Schnellkurs! Drucken Sie diese Datei am besten 
  9. aus und legen sie neben ihren Computer. Mit dieser Anleitung lernen Sie 
  10. in 10 Schritten die wichtigsten Möglichkeiten von ERGO!pro kennen.
  11.  
  12. Haben Sie ERGO!pro korrekt installiert, wie es in der Datei WICHTIG.TXT
  13. beschrieben ist? Dann frisch ans Werk! 
  14.  
  15.  
  16. 1. ERGO!pro starten und einrichten
  17. ----------------------------------
  18. Mit Doppelklick auf ERGODEMO.APP geht es los. Sie befinden sich nun in der 
  19. Shell. Dieser müssen Sie als erstes mitteilen, wo sich Interpreter, Compi-
  20. ler etc. befinden.
  21. Rufen Sie dazu den Menüpunkt 'Parameter -- GFA-BASIC-Sets' auf. Wie Sie hier 
  22. sehen, sind die vier leeren Felder mit den passenden Dateinamen zu belegen. 
  23. Mit einem DOPPELKLICK auf ein Feld rufen Sie die Dateiauswahlbox auf. Wenn 
  24. die Felder belegt sind, sollten Sie oben noch einen Namen für das 'Set' 
  25. eintragen, schreiben Sie zunächst einfach mal 'GFA' dahin.
  26. Nach Beenden des Dialogs sehen Sie, daß im Projektfenster dieser Name unten 
  27. sichtbar ist. 
  28. Wichtig sind diese Sets (und ihre Namen) dann, wenn Sie verschiedene 
  29. Interpreter, Compiler oder Libraries verwenden (3.5 und 3.6, gepatchte und 
  30. ungepatchte,...). Diese müssen nur einmal eingestellt werden und können dann 
  31. im Projektfenster über das Popup direkt abgerufen werden.
  32. Mit 'Parameter -- Parameter sichern' tragen Sie den Stand der Dinge 
  33. in die INF-Datei ein, und können nach dem nächsten Programmstart an dieser
  34. Stelle weitermachen.
  35.  
  36.  
  37. 2. GFA-Datei wählen
  38. -------------------
  39. Nun will ERGO!pro wissen, welches Programm Sie denn eigentlich bearbeiten
  40. wollen. Hierzu rufen Sie den Menüpunkt 'Datei -- GFA-Datei...' auf und
  41. können im Fileselektor die gewünschte Datei suchen.  Ihr Namen wird dann
  42. automatisch in das erste Feld des Projekt-Fensters eingetragen. 
  43. Darunter ist der Name der erzeugten Programmdatei zu sehen (auch wenn sie
  44. noch garnicht erstellt wurde, dann ist er eben 'disabled' dargestellt).
  45. Natürlich der Name nicht so übernommen werden, sondern kann nach Belieben 
  46. abgeändert werden. Doppelklick auf den Eintrag genügt!
  47.  
  48.  
  49. 3. GFA-Datei bearbeiten und übersetzen
  50. --------------------------------------
  51. Über 'Programme -- GFA-Basic' rufen Sie nun den Interpreter auf, wobei 
  52. die gewählte GFA-Datei automatisch mit geladen wird. So können Sie 
  53. gleich mit der Bearbeitung Ihres Programmes beginnen. Noch schneller 
  54. kommen Sie übrigens mit der Taste 'G' oder einem Einfachklick auf den 
  55. GFA-Dateinamen (im Projektfenster) in den Interpreter. 
  56. Wollen Sie nun ihr Programm übersetzen und binden, so rufen Sie einfach
  57. 'Datei -- Erstellen' auf (oder die Taste 'M' für MAKE) und schon werden
  58. Compiler und Linker des GFA-Entwicklungssystens aufgerufen. Wie Sie sehen,
  59. erfolgen die Ausgaben im Fenster und am Ende des Vorgangs wird eine
  60. Projektinformation ausgegeben. So haben Sie immer Kontrolle über die 
  61. Abläufe und können auch die Fehlermeldungen des Compilers im Ausgabefenster 
  62. der Shell in Ruhe ansehen.
  63. Die Einstellung der Compiler- und Linkeroptionen wird im 'Parameter'-Menü
  64. aufgerufen. Wenn Sie zu diesen Dialogen irgendwelche Fragen haben...kein 
  65. Problem: Überall gibt's Hilfe:
  66.  
  67.  
  68. 4. HILFE!!
  69. ----------
  70. Hilfen gibt's in ERGO!pro an allen Ecken und Enden. Zunächst sehen Sie den 
  71. Menüpunkt 'Extras -- Hilfe'. Hiermit wird die Online-Hilfe zu ERGO!pro
  72. aufgerufen, die Ihnen eine komplette Anleitung und Referenz zu allen
  73. Funktionen und Aspekten des Programms bietet. Die fett-unterstrichenen
  74. Begriffe sind 'Querverweise', die auf weitere Hilfs-Texte führen. So kann
  75. man sich bequem bis zu allen gesuchten Punkten 'durchklicken'.
  76. Dieselbe Hilfe wird aufgerufen, wenn Sie innerhalb eines Dialogs den
  77. HELP-Button betätigen. Im Unterschied zu vorher schaltet die Hilfe nun 
  78. gleich zu dem passenden Text, welcher den Dialog und seine Unterpunkte
  79. erläutert.
  80.  
  81. 5. Noch mehr Hilfe .. das ACC
  82. -----------------------------
  83. Neben diesen Hilfen, die ja nur ERGO!pro selbst betreffen, werden auch 
  84. alle Fragen zu GFA-Basic beantwortet: Rufen Sie dazu einfach das ACC 
  85. auf. Hier finden sich weitere Erläuterungen zur Bedienung. Der Clou 
  86. dabei ist die Kommunikation mit dem Interpreter, die in beide Richtungen 
  87. funktioniert. Lassen Sie sich dieses Bonbon nicht entgehen!! Mehr 
  88. Hinweise dazu gibt es im Accessory selbst sowie in der Online-Hilfe.
  89. Übrigens: Sollten Sie bei der Anzeige der Hilfsgraphik zum Thema 'String-
  90. feld-Organisation' Pixelmüll am oberen Bildschirmrand bekommen, so liegt
  91. das an der Unart des GFA-Interpreters, nur 16kB für das System und für 
  92. ACCs freizulassen. Selbstverständlich gibt es dafür eine Lösung. Diese
  93. wird in Form des GFA_PATCH-Programms auf der ERGO!pro-Diskette mitgelie-
  94. fert. Lesen Sie dazu auch das Kapitel 'Stolpersteineß' in der Online-Hilfe
  95.  
  96. Nachdem nun ERGO!pro als Entwicklungs-Shell und kontext-sensitives Online-
  97. Hilfssystem vorgestellt wurde, kommen nun weitere Highlights, nämlich die
  98. Analyse- und Bearbeitungsfunktionen:
  99.  
  100.  
  101. 6. Die Analyse:
  102. ---------------
  103. Mit 'Bearbeiten -- XREF-Analyse' starten Sie die Analyse ihres Programmes.
  104. Die Demo-Version analysiert beliebig große Programme, jedoch läuft sie 
  105. sehr gebremst ab. 
  106. Nach Ende der Analyse sehen Sie nun, daß der Button [ XRB ] im 
  107. Projektfenster schwarz statt grau ist. Das zeigt Ihnen, daß eine 
  108. Analysedatei angelegt worden ist. ERGO!pro bietet nun vielfältige 
  109. Möglichkeiten, diese Analyse für Sie auszuwerten und auszugeben. Wir 
  110. wollen hier nur drei davon durchführen: 
  111.  
  112. a) Mit 'Ausgabe -- Baumdiagramm' erhalten Sie ein komplettes 
  113.    Strukturdiagramm zu Ihrem Programm. Wenn Sie im Ausgabedialog auf 
  114.    'Drucker' schalten, so sollten Sie vorher eine passende Drucker-
  115.    anpassungsdatei in das betreffende Feld dieses Dialogs eintragen
  116.    (da die Dateien so ähnlich wie die Drucker heißen, dürften Sie schon 
  117.    die richtige finden).
  118.    
  119. b) Mit 'Ausgabe -- XRef-Analyse' wird ein großer Dialog aufgerufen. 
  120.    Stellen Sie hier 'Hilfstexte' an, 'Unterprogramme auflisten' aus.
  121.    Dann wählen Sie bei 'Analyse' den Punkt 'alle Variablen & Prozeduren',
  122.    womit eine vollständige Ausgabe der Crossreferenzinformationen  
  123.    erfolgt. Stellen Sie zusätzlich 'Verweise mit Prozedurennamen' ein.
  124.    Da diese Liste evt. sehr lang werden könnte, lenken Sie die Ausgabe
  125.    zunächst besser in das Fenster.
  126.  
  127.    Eine kompaktere Ausgabe, die zum Ausdrucken evt. eher geeignet ist,
  128.    erhalten Sie über die Einstellung 'Verweise mit Prozedurnummern'.
  129.    Damit Sie die Nummern richtig 'lesen' können, müssen dazu aber auch 
  130.    'Unterprogramme auflisten' ankreuzen. Dies liefert eine chronologisch
  131.    numerierte Liste aller Unterprogramme.
  132.  
  133.    Mit dieser Liste haben Sie eine komplette und verläßliche Übersicht
  134.    darüber, welche Variable wo und wie verwendet wird, welche Prozedur 
  135.    wo und wieoft aufgerufen wird. Dies kann eine enorme Hilfe beim 
  136.    Bearbeiten mittlerer und größerer Programme sein. Umständliches 
  137.    Umhersuchen im Quelltext entfällt damit.
  138.    Noch nützlicher ist allerdings die Diagnose:
  139.  
  140. c) Stellen Sie im gerade besprochenen Dialog im Feld 'Analyse' den Punkt
  141.    'fehlerhafte Verwendungen' ein. Außerdem sollte 'Fehlermeldungen als 
  142.    Texte' eingestellt sein.
  143.    Nun erhalten Sie eine gefilterte Liste, bei der ERGO!pro versucht alle
  144.    Situationen zu finden, in denen Sie Variablen fehlerhaft oder zweifel-
  145.    haft eingesetzt haben. Sie werden vielleicht überrascht sein, wieviel 
  146.    'Müll' sich im Laufe der Zeit in Ihrem Programm angesammelt hat. Auch 
  147.    lassen sich manche Tippfehler in Variablennamen damit finden.  Viele 
  148.    Sachen werden aufgedeckt, die - wenn überhaupt - nur mit stundenlanger 
  149.    mühevoller Suche zu finden gewesen wären.
  150.  
  151. Experimentieren Sie nun mit den Einstellungen im XRef-Ausgabe-Dialog, um 
  152. herauszufinden, wie vielfältig Sie die Ausgabe und Auswertung steuern 
  153. können. 
  154. HINWEIS: In der Demo-Version werden nur die Variablen mit den Anfangsbuch-
  155. staben 'a' - 'k' ausgegeben.
  156.  
  157.    
  158. 7. Die ONLINE-Analyse
  159. ---------------------
  160. Neben der Listen-Ausgabe der Analyse haben Sie auch direkten Zugriff auf 
  161. einzelne Informationen. Haben Sie noch die GFA-Datei mit der gerade erzeug-
  162. ten XRB-Datei im Projektfenster eingestellt?   Dann gehen Sie nun in den 
  163. Interpreter (Taste 'G') und stellen den Cursor auf den Namen einer Prozedur
  164. oder Variablen. Nun rufen Sie das Help-ACC auf und siehe da .... die Verweis-
  165. liste zum betreffenden Namen erscheint im Fenster! Zwei Dinge sind hieran zu 
  166. sehen: 1. Das ACC erlaubt auch den Zugriff auf die XRef-Analyse und 
  167.        2. funktioniert auch hier die Kommunikation mit dem Interpreter. 
  168. Für weitere Abfragen geben Sie einfach den Namen der Variablen ein. 
  169. 'Wo eingeben?', na tippen Sie einfach los, es erscheint dann sofort die 
  170. Eingabebox. Es genügt auch der Anfang des Namens, gefolgt von einem Stern. 
  171. Die Wildcars '*' und '?' funktionieren dabei wie gewohnt und können sogar 
  172. auch mehrfach eingesetzt werden. Hängen Sie ein großes 'D' an das Suchmuster, 
  173. dann erhalten Sie die 'Diagnosemeldungen' zu den Namen. Aber halt, die Abfra-
  174. gemöglichkeiten sind ja im ACC auf eigenen Help-Screens ausführlich erklärt. 
  175. Und dank  der Beispiele bleibt keine Frage offen. Mit ESC kann übrigens jeder-
  176. zeit in den GFA-Modus und zurückgeschaltet werden. 
  177.  
  178. Direkter Zugriff auf die XRef, sogar aus dem Interpreter heraus, bequemer 
  179. geht's nicht! Oder etwa doch?? Dann probieren Sie mal den 'Informer': 
  180.  
  181.  
  182. 8. Der Informer
  183. ---------------
  184. Sind Sie nun wieder in der Shell? Ok, dann geht's weiter: mit 'Bearbeiten -- 
  185. Informer' erscheint ein Dialog, der folgendermaßen eingestellt sein sollte: 
  186. 'Hinweise einfügen', 'in alle Prozeduren' und alle vier Kreuze gesetzt. 
  187. Mit 'OK' geht's los. Im Ablauffenster sehen Sie, daß eine Datei erzeugt wird, 
  188. die fast wie Ihre original GFA-Datei heißt, nur daß sie eine Schlange (~) im 
  189. Namen hat. Wenn alles fertig ist, sehen Sie im Projektfenster, daß der Knopf
  190. [ ~.GFA ] schwarz ist. Auch er besagt, daß die zugehörige 'Schlange-Datei' 
  191. erzeugt worden ist. Laden Sie diese nun in den Interpreter, indem Sie mit 
  192. der Maus auf den besagten Knopf klicken. Haben Sie's? Dann schauen Sie mal 
  193. in die Prozeduren hinein.. und, was sehen Sie? Die XRef-Informationen zu allen
  194. Prozeduren fein säuberlich eingetragen. hierfür müssen Sie also nicht einmal 
  195. mehr in das Help-ACC gehen! Nun geht's also wirklich nicht mehr bequemer!! 
  196. Ach ja, wenn Sie mit dieser Datei weiterarbeiten wollen, so müssen Sie diese 
  197. natürlich wieder unter dem Originalnamen abspeichern.
  198.  
  199.  
  200. 9. Der Präpozessor
  201. -------------------
  202. Für effektive Programmierung unerläßlich und bislang nur den C-Programmierern 
  203. vorbehalten: Der Präprozessor! Was er macht und wie er funktioniert?? Naja, 
  204. was soll hier alles nochmal hingeschrieben werden, das sowieso schon in den 
  205. Hilfstexten steht? Rufen Sie den Präprozessor-Dialog auf und studieren Sie die
  206. Hilfen dazu, dann dürften keine Fragen mehr offen bleiben. 
  207.  
  208. Der große Vorteil des ERGO!pro-Präprozessors: Er verarbeitet direkt die GFA-Datei 
  209. und ist daher affig schnell! (Abgesehen von der künstlichen Demo-Bremse). Und: 
  210. Er kann mit dem Compiler und Linker zu der vollautomatischen 'Extended-Make-
  211. Funktion' zusammengeschaltet werden. Aber die ist leider in der Demo-Version 
  212. gesperrt. Aber ahnen Sie bereits, wie komfortabel Sie in Zukunft Ihre Projekte 
  213. erstellen können?
  214. Übrigens: Natürlich ist auch diese Demoversion auf Knopfdruck mit der 'Extended-
  215. Make-Funktion' erzeugt worden. 
  216. Im Ordner \BEISPIEL finden Sie ein kurzes Listing, das die Anwendung der 
  217. Präprozessorbefehle demonstriert.
  218.  
  219. 10. Ein Projekt definieren
  220. --------------------------
  221. Ihr 'Projekt' besteht bisher nur aus dem Namen von GFA-Datei und erzeugter 
  222. Programmdatei sowie den zugehörigen Compiler- und Linkereinstellungen. 
  223. Diese werden mit 'Datei -- PRJ sichern' (oder ^S) abgespeichert und 
  224. können über 'Datei -- PRJ öffnen' wieder geladen werden. Bis zu 100 Projekte
  225. (verteilt auf 10 Projektgruppen) sind übrigens direkt abrufbar. Klicken Sie 
  226. mal mit der rechten Maustaste... schon erscheint das Projektauswahlfenster. 
  227. Hier können Sie die hundert Projekte fest ablegen und mit Tastendruck abrufen 
  228. und bearbeiten.
  229.  
  230. Natürlich kann so ein Projekt noch mehr enthalten. Wie Sie sehen, sind die
  231. sechs mittleren Felder des Projektfensters noch unbelegt. Das werden wir nun
  232. ändern: Benutzen Sie RSC-Dateien? Dann tragen Sie die zugehörige RSC-Datei
  233. in eines der Felder ein (wie gewohnt per Doppelklick).  Doch was nützt diese
  234. ohne ein `Resource-Constuction-Set'? Rufen Sie daher 'Parameter --Zugriffspfade'
  235. auf und tragen hier Ihr RCS (Interface, ORCS, RCS2,...) ein. Wichtig: Gleich
  236. den Extender 'RSC' mit eintragen (hierzu ist der [Paramete...]-Knopf rechts 
  237. vom Datei-Feld anzuklicken, worauf der betr. Unter-Dialog erscheint). 
  238. So, nun wieder zurück zum Projektfenster und einen Einfachklick auf den 
  239. RSC-Eintrag durhcgeführt... und schon ist das RCS gestartet und die RSC-Datei 
  240. geladen. 
  241.  
  242. Das war nun das Grundmuster. Nach demselben Schema können Sie nun z.B. Texte 
  243. eintragen und einen Editor oder ein Schreibprogramm dazu anmelden. Oder
  244. Bilddaten eintragen und ein Malprogramm anmelden. Oder sogar weitere GFA-
  245. Programme (der Interpreter ist ja bereits angemeldet). Oder, oder, oder... 
  246. Wichtig nur: Für eine reibungslose Zusammenarbeit müssen die passenden Extender
  247. angemeldet sein! So können Sie die Daten mit Mausklick aufrufen. 
  248.  
  249. Da einige der angemeldeten Programme nicht für ein einziges, sondern für alle
  250. Projekte gelten sollen, unterscheidet die Shell zwischen allgemeinen und pro-
  251. jektgebundenen Programmen. Näheres sehen Sie im 'Zugriffspfade'-Dialog.
  252.  
  253.  
  254.                     
  255. Und was noch ??
  256. ---------------
  257. Nachdem nun der Schnelldurchgang beendet ist, werden Sie die anderen Möglich-
  258. keiten und Funktionen von ERGO!pro bestimmt selbst auskundschaften können. 
  259.  
  260.  
  261.  
  262. Viel Spaß beim Probieren wünschen die ERGO!pro-grammierer
  263.                                         
  264. Gregor Duchalski und Christof Schardt
  265.  
  266.